RIL GetDataCompression 



HRESULT RIL_GetDataCompression(HRIL hRil) 
Retrieves data compression options 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

Comments Asynchronous. IpData points to an RILDATACOMPINFO structure. 



RIL GetPevCaps 

HRESULT RIL_GetDevCaps(HRIL hRil, DWORD dwCapsType) 
Retrieves specified device capabiHties 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

dwCapsType 

type of caps class to retrieve 

Comments Asynchronous. 

dwCapsType {RILjCAPSTYPEJ IpData 
""jyiAL pomts to an RILCAPSDIAL structure 

'^_DTMFDURATIONRANGE points to an RILRANGE structure (values in 

milliseconds) 

*_CALLMGTCMDS points to DWORD containing a combination of 
RIL_CAPS_CALLCMD_ constants 

""^BEARERSER VICE points to an RILC APSBE ARERS VC structure 
""JtLP points to an array of RILAPSRLP structures 

^_EQUIPMENTSTA TES points to DWORD containmg a combination of 
RIL_CAPS_EQSTATE_ constants 

*_PBSTORELOCATIONS points to DWORD contaming a combination of 
RIL_CAPS_PBLOC_ constants 

'^_PBINDEXRANGE points to an RILRANGE structure 
""J^BENTRYTEXTLENGTH points to a DWORD 

*_MSGSER VICETYPES points to DWORD containing a combination of 
RIL_CAPS_MSGSVCTYPE_ constants 

*_MSGMEMORYLOCATIONS points to an RILCAPSMSGMEMORYLOCATIONS 
structure 

""^BROADCASTMSGLANGS points to DWORD containing a combination of 
RIL_CAPS_DCSLANG_ constants 

''JdSGCONFIGINDEXRANGE points to an RILRANGE structure 
*_MSGSTA TUSVALUES points to DWORD containing a combmation of 
RIL_CAPSJ4SGSTATUS_ constants 

""JPREFOPINDEXRANGE points to an RILRANGE structure 
'^J.OCKFA CILITIES points to DWORD containing a combination of 
RIL_CAPS_LOCKFACILITY_ constants 
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''J.OCKINGPWDLENGTHS points to an array of 
RILCAPSLOCKINGPWDLENGTH structures 

*_BARRTYPES points to DWORD containing a combination of 

RIL_CAPS_BARRTYPE_ constants 

""JARRINGPWDLENGTHS points to an array of 
RILCAPSBARRINGPWDLENGTH structures 

"" FOR WARDINGREASONS points to DWORD containing a combination of 
RIL_CAPSJ'WDREASON_ constants 

"^JSIMTOOLKITNOTIFICATIONSpomts to a TBD SIMTOOLKIT structure 
""JNFOCLASSES points to DWORD containing a combination of 
RIL_CAPSJNFOCLASS_^ constants 

""JISCSD points to an RILCAPSHSCSD structure 

*_GPRS points to an RILCAPSGPRS structure 



RIL GetPialedldSettings 

HRESULT RIL_GetDiaIedIdSettings(HRIL hRil) 

Retrieves the current DialedID settings 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 
Comments Asynchronous. IpData points to an RILDIALEDIDSETTINGS structure. 



RIL GetEquipmentlnfo 

HRESULT RIL_GetEquipmentInfo(HRIL hRil) 
Retrieves manufacturer equipment information 
Parameters HRil 

handle to RIL instance returned by RIL_Initialize 

Comments Asynchronous. IpData points to an RILEQUIPMENTINFO structure. 



RIL GetEquipmentState 

HRESULT RIL_GetEquipmentState(HRIL hRil) 

Retrieves currently set equipment state 
Parameters hRil 

handle to RIL instance returned by RIL_InitiaIize 
Comments Asynchronous. IpData points to an RILEQUIPMENTSTATE structure. 
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RIL GetErrorCorrection 



HRESULT RIL_GetErrorCorrection(HRIL hRil) 
Retrieves error correction options 

Parameters hM 

handle to RIL instance returned by RILJnitialize 
Comments Asynchronous. IpData points to an RBLERRORCORRECTIONINFO structure. 



RIL GetGPRSAddress 

HRESULT RIL_GetGPRSAddress(HRIL hRil, DWORD dwContextID) 
Gets the PDP address for a particular context 
Parameters hRil 

handle to RIL instance returned by RIL_Initiali2e 

dwContexfID 

identifies the context 

Comments Asynchronous. IpData points to an array of WCHAR values indicating the address. 



RIL GetGPRSAttached 

HRESULT RIL_GetGPRSAttached(HRIL hRil) 

Gets the GPRS attach state 
Parameters hRil 

handle to RIL instance returned by RILJnitialize 
Comments Asynchronous. IpData points to a BOOL indicating attach state. 



RIL GetGPRSClass 

HRESULT RIL_GetGPRSClass(HRn. hRil) 
Retrieves the current GPRS class 

Parameters hRil 

handle to RIL instance returned by RILJnitialize 
Comments Asynchronous. IpData points to a RIL_GPRSCLASS_ constant. 



RIL GetGPRSContextActivatedList 

HRESULT RIL_GetGPRSContextActivatedList(HRn. hRil) 
Gets the GPRS activation state for all contexts 
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Parameters hM 

handle to RIL instance returned by RIL_Initialize 

Comments Asynchronous. IpData points to a RILGPRSCONTEXT ACTIVATED indicating 

activation state. 



Parameters 
Comments 



RIL GetGPRSContextList 

HRESULT RIL_GetGPRSContextList(HRIL hRil) 

Retrieves a list GPRS contexts 

hRil 

handle to RIL instance returned by RIL_Initialize 
Asynchronous. IpData points to a RILGPRSCONTEXT structure. 



Parameters 
Comments 



RIL GetGPRSRegistrationStatus 

HRESULT RIL_GetGPRSRegistrationStatus(HRIL hRit) 

Retrieves the current GPRS registration status 

hRil 

handle to RIL instance returned by RIL__Initialize 

Asynchronous. IpData points to a RIL_REGSTAT_ constant. 



RIL GetHideConnectedldSettings 

HRESULT RIL_GetHideConnectedIdSettings(HRIL hRil) 

Retrieves the current HideConnectedID settings 

hRil 

handle to RIL instance returned by RILJnitialize 
Asynchronous, IpData points to an RILHIDECONNECTEDIDSETTINGS structure. 



Parameters 
Comments 



Parameters 
Comments 



RIL GetHideldSettings 

HRESULT RIL_GetHideIdSettings(IIRIL hRil) 

Retrieves the current HidelD settings 

hRil 

handle to RIL instance returned by RILJnitialize 
Asynchronous. IpData points to an RILHIDEIDSETTINGS structure. 
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RIL GetHSCSDCallSettings 



HRESULT RIL_GetHSCSDCaUSettings(HRIL hRil) 
Retrieves High Speeed Circuit Switched Data options 

Parameters hRil 

handle to RIL instance returned by RIL_InitiaIize 

Comments Asynchronous. IpData points to an RILCALLHSCSDEVFO structure. 



RIL GetHSCSDOptions 

HRESULT RIL_GetHSCSDOptions(HRIL hRil) 
Retrieves High Speeed Circuit Switched Data options 

Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

Comments Asynchronous. IpData points to an RILHSCSDINFO structure. 



RIL GetLineStatus 

HRESULT Rn._GetLineStatus(HRIL hRil) 
Retrieves the phone line status 

Parameters hRil 

handle to RIL instance returned by RILJnitialize 
Comments Asynchronous. IpData points to DWORD contaming RIL_LINESTAT_ constant. 



RIL GetLockingStatus 

HRESULT RIL_GetLockingStatus(HRIL hRil, DWORD dwFacility, LPCSTR 
IpszPassword) 

Retrieves locking status for the specified facility 
Parameters hRil 

handle to RIL instance returned by RILJnitialize 

dwFacility 

facility to retrieve locking status for {RIL_LOCKFACILITY_ constant) 
IpszPassword 

password to retrieve locking status (can be NULL if password isn't required; no 
longer than MAXLENGTH__PASSWORD chars) 

Comments Asynchronous. IpData points to a DWORD containing a RIL_LOCKINGSTATUS_ 

constant. 
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RIL GetMinimumQualityOfServiceList 

HRESULT RIL_GetMinimumQualityOfServiceList(HRIL hRil) 
Gets the miniinum quality of service profile for all contexts 

Parameters hRil 

handle to RIL instance returned by RIL_Initialize 
Comments Asynchronous, IpData points to a RILGPRSQOSPROFILE structure. 



RIL GetMOSMSService 

HRESULT RIL_GetMOSMSService(HRIL hRil) 

Retrieves the preferred SMS service option for mobile originated messages 

hRil 

handle to RIL instance returned by RIL_Initialize 
Asynchronous. IpData points to a RIL_MOSMSSERVICE_ constant. 



RIL GetMsgConfig 

HRESULT RIL_GetMsgConfig(HRIL hRil) 
Gets currently set messaging configuration 
hRil 

handle to RIL instance returned by RIL_Initialize 
Asynchronous. IpData points to an RILMSGCONFIG structure. 



RIL GetMsgServiceOptions 

HRESULT RIL_GetMsgServiceOptions(HRIL HRil) 

Gets currently set messaging service options 

hRil 

handle to RIL instance returned by RIL_Initialize 
Asynchronous. IpData points to an RILMSGSERVICEINFO structure. 



RIL GetOperatorList 

HRESULT Rn._GetOperatorList(HRn. hRil) 
Retrieves the list of available operators 
Parameters hRil 

handle to RIL instance returned by RILJnitialize 



Parameters 
Comments 



Parameters 
Comments 



Parameters 
Comments 
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Comments 



Asynchronous. IpData points to an array of RILOPERATORINFO structures. 



RIL GetPhonebookOptions 

HRESULT RIL_GetPhonebookOptions(HRIL hRil) 
Retrieves currently set phonebook options 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

Comments Asynchronous. IpData points to an RILPHONEBOOKINFO structure. 



RIL GetPhoneLockedState 

HRESULT RIL_GetPhoneLockedState(HRIL hRil) 

Retrieves current locked state of the phone 

hRil 

handle to RIL instance returned by RIL_Initialize 

Asynchronous. IpData points to a DWORD containing a RIL_LOCKEDSTATE_ constant 



RIL GetPreferredOperatorList 

HRESULT RIL_GetPreferredOperatorList(HRIL hRil, DWORD dwFormat) 

Retrieves the list of preferred operators 

hmi 

handle to RIL instance returned by RIL_Initialize 

dwFormat 

format to use for the operator names in the list 
Asynchronous. IpData points to an array of RILOPERATORINFO stmctures. 



RIL GetRadioPresence 

HRESULT RIL_GetRadioPresence(HRIL hRIL, DWORD* dwRadioPresence) 
Proxy API to determine if the Radio is present or Not (Is the RIL driver Loaded?) 
hRIL 

handle to RIL instance returned by RIL_Initialize 

dwRadioPresence 

pointer to a DWORD (ouput param contains values from 
RIL_RADIOPRESENCE_*) 

Synchronous 



Parameters 
Comments 



Parameters 



Comments 



Parameters 



Comments 
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RIL GetRegistrationStatus 



HRESULT RIL_GetRegistrationStatus(HRIL hRil) 
Retrieves the current phone registration status 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

Comments Asynchronous. IpData points to a RIL_REGSTAT_ constant. 



RIL GetRequestedQualityOfServiceList 

HRESULT RIL_GetRequestedQuaIityOfServiceList(HRIL hRil) 
Gets the requested quahty of service profile for all contexts 
Parameters hRil 

handle to RIL instance returned by RIL_InitiaIize 

Comments Asynchronous. IpData points to a RELGPRSQOSPROFILE structure. 



RIL GetRLPOptions 

HRESULT RIL_GetRLPOptions(HRIL HRil) 
Retrieves currently set Radio Link Protocol options 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

Comments Asynchronous. IpData points to an RILRLPINFO structure. 



RIL GetSerialPortHandle 

HRESULT RIL_GetSerialPortHandle(HRIL hRU, HANDLE* IphSerial) 
Retrieves a serial port handle to be used for data conununications 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

IphSerial 

pointer to the serial port handle 
Comments Synchronous. Client is responsible for closing the handle returned in IphSerial 



RIL GetSerialPortStatistics 

HRESULT RIL_GetSerialPortStatistics(HRIL hRiU RILSERIALPORTSTATS* 

IpSerialPortStats) 
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Retrieves a serial port handle statistics 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

IpSerialPortStats 

pointer to the statistics structure 

Comments Synchronous 



RIL GetSignalQuality 

HRESULT RIL_GetSignaIQuality(HRIL hRil) 
Retrieves information about the received signal quahty 

hmi 

handle to RIL instance returned by RILJnitialize 
Asynchronous. IpData points to a RILSIGNALQUALITY structure. 



RIL GetSimRecordStatus 

HRESULT RIL_GetSiinRecordStatus(HRIL hRil, DWORD dwFilelD) 

Retrieves SIM Record Status 

HRil 

handle to RIL instance returned by RIL__Initialize 

dwFilelD 

address of the file to read 

Asynchronous. IpData points to RILSIMRECORDSTATUS 



RIL GetSimToolkitProfile 

HRESULT RIL_GetSimTooIkitProfile(HRIL hRU) 

Retrieves SIM Toolkit terminal profile 

HRil 

handle to RIL instance returned by RIL_Initialize 
Asynchronous. IpData points to an array of BYTEs. 



RIL GetSubscriberNumbers 

HRESULT RIL_GetSubscriberNuinbers(HRIL hRil) 
Restrieves information about subscriber numbers 
Parameters HRil 

handle to RIL instance returned by RIL_InitiaIize 



Parameters 
Comments 



Parameters 



Comments 



Parameters 
Comments 
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Comments 



Asynchronous, IpData points to an array of RILSUBSCRIBERINFO structures. 



RIL GetSystemTime 

HRESULT RIL_GetSysteinTime(HRIL hRil) 
Retrieves the systemtime from the network 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

Comments Asynchronous. IpData points to a SYSTEMTIME structure. This feature is currently not 

used in Stinger and is untested. 



RIL GetUserldentity 

HRESULT RIL_GetUserIdentity(HRIL hRU) 
Retrieves International Mobile Subscriber Identity of the phone user 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

Comments Asynchronous. IpData points to an array of chars 



RIL GPRSAnswer 

HRESULT Rn._GPRSAnswer(HRIL hRil) 
Answers an incoming GPRS activation request 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

Comments Asynchronous. IpData is NULL, 



RIL Hangup 

HRESULT RIL_Hangup(HRIL HRit) 
Hangs up all calls currently in progress 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

Comments Asynchronous. IpData is NULL. 
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RJL Initialize 

HRESULT RIL_Initialize(DWORD dwindex, RILRESULTCALLBACK pfnResult, 
RILNOTIFYCALLBACK pfiiNotify, DWORD dwNotificationClasses, DWORD 
dwParam, HRIL* IphRil) 
Initializes RIL for use by this client 
Parameters dwindex 

index of the RIL port to use (e.g., 1 for RILl :) 

pfnResuh 

function result callback 

pfnNotiJy 

notification callback 

dwNotificationClasses 

classes of notifications to be enabled for this client 

dwParam 

custom parameter passed to result and notififcation callbacks 
IphRil 

returned handle to RIL instance 

Comments Synchronous RIL only supports single threaded RIL handles. The RIL validates the 

application's RIL handle before using it. No application can use/close a RIL handle that it 
does not own. 



RIL InitializeEmergency 

HRESULT RIL_InitiaIizeEmergency(DWORD dwindex, RILRESULTCALLBACK 

pfriResult, RILNOTIFYCALLBACK pfnNotify, DWORD dwNotificationClasses, 
DWORD dwParam, HRIL* IphRil) 
Initializes RIL for use by this emergency call module 
Parameters dwindex 

index of the RIL port to use (e.g., 1 for RILl :) 

pfiiResult 

function result callback 

pfitNotify 

notification callback 

dwNotification Classes 

classes of notifications to be enabled for this client 

dwParam 

custom parameter passed to result and notififcation callbacks 
IphRil 

returned handle to RIL instance 
Comments Synchronous 
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RIL ManageCalls 



HRESULT RIL_ManageCalls{HRIL hRil, DWORD dwCommand, DWORD dwID) 
Modifies the state of active, held, and waiting calls 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

dwCommand 

call modification conmnand to be performed (RIL_CALLCMD_ constant) 
dwID 

ID of the call to be modified (only for RIL_CALLCMD_RELEASECALL and 
RILJ0ALLCMD_H0LDALLBUT0NE) 

Comments Asynchronous. IpData is NULL. 



RIL ReadMsg 

HRESULT RIL_ReadMsg(HRIL hRil, DWORD dwindex) 
Reads a message from the current storage location 
Parameters hRil 

handle to RIL instance returned by RIL ^Initialize 

dwindex 

index of the message to be read 

Comments Asynchronous. IpData points to an RILMESSAGEINFO structure. 



RIL ReadPhonebookEntries 

HRESULT RIL_ReadPhonebookEatries(HRIL hRil, DWORD dwStartlndex, DWORD 
dwEndlndex) 

Reads phonebook entries from the specified range of indices of the current storage location 
Parameters HRil 

handle to RIL instance returned by RIL_Initialize 

dwStartlndex 

starting index of the range 

dwEndlndex 

ending index of the range 

Comments Asynchronous. IpData points to an array of RILPHONEBOOKENTRY structures. 
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RIL RegisterOnNetwork 



HRESULT RIL_RegisterOnNetwork(HRIL hRil, DWORD dwMode, const 
RILOPERATORNAMES* IpOperatorNames) 
Registers the ME with a network operator 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

dwMode 

operator selection mode {RIL_OPSELMODE_ constant) 

IpOperatorNames 

operator to be selected (can be NULL ifdwMode is 
RIL_OPSELMODE_A UTOMATIQ 

Comments Asynchronous. IpData is NULL. 



RIL RemoveCallForwarding 

HRESULT RIL_RemoveCalIForwarding(HRIL hRil, DWORD dwReason, DWORD 
dwInfoClasses, DWORD dwAddressId) 
Removes a Call Forwarding rule 
Parameters hRil 

handle to RIL instance returned by RIL_InitiaIize 

dwReason 

forwarding reason to remove Call Forwarding for {RLL_FWDREASON_ constant) 
dwInfoClasses 

information classes to remove Call Forwarding for (combination of 
RIL_INFOCLASS_ constants) 

dwAddressId 

address ID of line on which to change call forwarding settings 
Comments Asynchronous. IpData is NULL. 



RIL RemovePreferredOperator 

HRESULT RIL_RemovePreferredOperator(HRn. hRil, DWORD dwindex) 
Removes a specified operator from the list of preferred operators 
Parameters HRil 

handle to RIL instance returned by RILJnitialize 

dwindex 

storage index of the preferred operator to remove 
Comments Asynchronous. IpData is NULL, 
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RIL RestoreMsgConfig 

HRESULT RIL_RestoreMsgConrig(HRIL hRil, DWORD dwindex) 
Restores a previously saved messaging configuration 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

dwindex 

index of the configuration to restore 
Comments Asynchronous. IpData is NULL. 



RIL SaveMsgConfig 

HRESULT RIL_SaveMsgConfig(HRIL hRil, DWORD dwindex) 
Saves currently set messaging configuration 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

dwindex 

index to be assigned to the stored configuration 
Comments Asynchronous. IpData is NULL. 



RIL SendDTMF 

HRESULT RIL_SendDTMF(HRIL hRil, LPCSTR IpszChars, DWORD dwDuration) 
Sends DTMF tones across an established voice call 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

IpszChars 

alphanumeric string representing DTMF tones to be sent (0-9, A-D, *, #) 
dwDuration 

new DTMF tone duration in milliseconds {RIL_DTMFDURATIONJ)EFA ULT 
corresponds to the manufacturer's default value) 

Comments Asynchronous, IpData is NULL, Function does not return until DTMF tone has 

completed. BUGBUG This does not allow press and hold DTMF functionality. 



RIL SendMsg 

HRESULT RIL_SendMsg(HRIL hRil, const RILMESSAGE* IpMessage, DWORD 

dwOptions) 

Sends a message 
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Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

IpMessage 

message to be sent 

dwOptions 

options (any combination of RIL JSENDOFT_ constants) 

Comments Asynchronous. IpData points to a DWORD conaining the reference number of the sent 

message. 



RIL SendMsgAcknowledgement 

HRESULT RIL_SendMsgAcknowledgement(HRIL hRil, BOOL fSuccess) 
Sends an message ackknowledgement 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

fSuccess 

TRUE if success acknowledgment is to be sent; FALSE otherwise 
Comments Asynchronous. IpData is NULL. On Phase 2 mobiles, the radio automatically sends SMS 

message ACKs. But in Phase 2+, the MMI is responsible for these ACKs, hense this 
function. 



RIL SendRestrictedSimCmd 

HRESULT RIL_SendRestrictedSimCmd(HRIL hRil, DWORD dwCommand, const 
RILSIMCMDPARAMETERS* IpParameters, const BYTE* IpbData, DWORD dwSize) 
Sends a specified restricted command to the SIM 

Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

dwCommand 

restricted command to be sent to the SIM (RIL_SIMCMD_ constant) 
IpParameters 

Parameters for the command to be sent (can be NULL if parameters aren't required) 
IpbData 

Data to be written to the SIM (can be NULL if data isn't required) 
dwSize 

Size of the data pointed to by IpbData in bytes 
Comments Asynchronous. IpData points to an RILSIMRESPONSE stmcture. 
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RIL SendSimCmd 

HRESULT RIL_SendSimCmd(HRIL hRil, const BYTE* IpbCommand, DWORD 
dwSize) 

Sends a specified command to the SIM 
Parameters hRil 

handle to RIL instance returned by RIL_InitiaIize 

IpbCommand 

command to be sent to the SIM 

dwSize 

size of the data pointed to by IpbCommand in bytes 
Comments Asynchronous. IpData points to an array of BYTEs. 



RIL SendSimToolkitCmdResponse 

HRESULT RIL_SendSimToolkitCmdResponse(HRIL hRil, const BYTE* IpbResponse, 
DWORD dwSize) 

Sends a response to an executed SIM Toolkit command 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

IpbResponse 

response to be sent 

dwSize 

size of the data pointed to by IpbResponse in bytes 
Comments Asynchronous. IpData is NULL. 



RIL SendSimToolkitEnvelopeCmd 

HRESULT RIL_SendSimToolkitEnvelopeCmd(HRIL hRil, const BYTE* 
IpbCommand, DWORD dwSize) 
Sends a SIM Toolkit envelope command 

Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

IpbCommand 

SIM Toolkit envelope command to be sent 

dwSize 

size of the data pointed to by IpbCommand in bytes 
Comments Asynchronous. IpData points to an array of BYTEs containing a response to the sent 

command. 
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RIL SendStoredMsg 

HRESULT RIL_SendStoredMsg(HRIL hRil, DWORD dwindex, DWORD dwOptions) 
Sends a message from the current storage location 
Parameters hRil 

handle to RIL instance returned by RIL_InitiaIize 

dwindex 

index of the message to be sent 

dwOptions 

options (any combination of RIL_SENDOPT_ constants) 

Comments Asynchronous. IpData points to a DWORD conaining the reference number of the sent 

message. This feature is not used in Stinger and is untested. 



RIL SendSupServicePata 

HRESULT RIL_SendSupServiceData(HRIL hRil, const BYTE* IpbData, DWORD 
dwSize) 

Sends supplementary service (USSD) data 
Parameters hRil 

handle to RIL instance returned by RILJnitialize 

IpbData 

data to be sent 

dwSize 

size of the data pointed to by IpbData in bytes 
Comments TBD 



RIL SetAudioDevices 

HRESULT RIL_SetAudioDevices(HRn. hRil, const RILAUDIODEVICEINFO* 

IpA udioDevicelnfo) 

Sets currently used transmit and receive audio devices 

Parameters HRil 

handle to RIL instance returned by RIL_InitiaIize 

IpAudioDevicelnfo 
audio devices to set 

Comments Asynchronous. IpData is NULL. 
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RIL SetAudioGain 



HRESULT ML_SetAudioGain(HRIL hM, const RILGAININFO* IpGainlnfd) 
Sets audio gain information 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

IpGainlnfo 

audio gain information to be sent 

Comments Asynchronous. IpData is NULL. 



RIL SetAudioMuting 

HRESULT RIL_SetAudioMuting(HRIL hRil, BOOL fBnable) 
Mutes or un-mutes the input audio device 

hmi 

handle to RIL instance returned by RIL_Iiiitialize 

fEnable 

TRUE if input audio device is to be muted; FALSE otherwise 
Asynchronous. IpData is NULL, 



RIL SetBearerServiceOptions 

HRESULT RIL_SetBearerServiceOptions(HRIL hRil, const RILBEARERSVCINFO* 

IpBearerServicelnfd) 

Sets data bearer service options 

hRil 

handle to RIL instance returned by RIL_Initialize 

IpBearerServicelnfo 

data bearer service options to set 

Asynchronous. IpData is NULL. 



RIL SetCallBarritigStatus 

HRESULT RIL_SetCallBarringStatus(HRIL Mz7, DWORD dwType, DWORD 
dwInfoClass, LPCSTR IpszPassword, DWORD dwStatus) 
Enables or disables the specified type of call barring 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 



Parameters 



Comments 



Parameters 



Comments 
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dwType 

type of call barring to enable/disable {RIL_BARRTYPE_ constant) 
dwInfoClass 

information class to enable/disable call barring for {RIL_INFOCLASS_ constant) 
IpszPassword 

password to enable/disable call barring (can be NULL if password isn't required; no 
longer than MAXLENGTH_PASSWORD chars) 

dwStatus 

status to be set {RIL_BARRINGSTATUS_ constant) 
Comments Asynchronous. IpData is NULL, 



RIL SetCallerldStatus 

HRESULT RIL_SetCallerIdStatus(HRIL hRil, DWORD dwStatus) 

Sets the current CallerlD status 

hRil 

handle to RIL instance returned by RIL ^Initialize 

dwStatus 

status to be set (RIL_SVCSTAT_ constant) 
Asynchronous. IpData is NULL, 



RIL SetCallForwardingStatus 

HRESULT RIL_SetCalirorwardingStatus(HRIL hRU, DWORD dwReason, DWORD 
dwinfo Classes, DWORD dwStatus, DWORD dwAddressId) 
Enables or disables the specified Call Forwarding rule 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

dwReason 

forwarding reason to enable/disable Call Forwarding for (RIL_FWDREASON_ 
constant) 
dwInfoClasses 

information classes to enable/disable Call Forwarding for (combination of 
RILJNFOCLASS^ constants) 

dwStatus 

status to be set {RIL_SVCSTAT_ constant) 
dwAddressId 

address ID of line on which to change call forwarding settings 
Comments Asynchronous. IpData is NULL. 



Parameters 



Comments 
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RIL SetCallWaitingStatus 

HRESULT RIL_SetCallWaitingStatus(HRIL hRil, DWORD dwInfoClasses, DWORD 
dwStatus) 

Enables or disables Call Waiting for the specified info class 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

dwInfoClasses 

information classes to enable/disable Call Waiting for 

dwStatus 

Status to be set {RIL_SVCSTAT_ constant) 
Comments Asynchronous. IpData is NULL, 



RIL SetClosedGroupSettings 

HRESULT RIL_SetClosedGroupSettings(HRIL hRil, const 
RILCLOSEDGROUPSETTINGS* IpSettings) 
Sets the Closed User Group settings 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

IpSettings 

settings to be set 

Comments Asynchronous. IpData is NULL. 



RIL SetCostlnfo 

HRESULT Rn._SetCostInfo(HRH. hRil, const RILCOSTEVFO* IpCostlnfo, LPCSTR 
IpszPassword) 

Sets advice-of-charge settings 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

IpCostlnfo 

advice-of-charge settings to set 

IpszPassword 

password requred to set advice-of-charge settings 

Comments Asynchronous. IpData points to a RILCOSTINFO structure. This feature is not used in 

Stinger and is untested. 
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RIL SetCurrentAddressId 

HRESULT RIL_SetCurrentAddressId(HRIL hRil, DWORD dwAddressId) 
Sets the current address identifier (see RILSUESCRIBERINFO) 

Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

dwAddressId 

identifies the new addressID to use 

Comments Asynchronous. IpData is NULL. 



RIL SetDataCompression 

HRESULT RIL_SetDataCompression(HRIL hRil, const RILDATACOMPINFO* 

IpDataCompInfd) 

Sets data compression options 

hRil 

handle to RIL instance returned by RIL_Initialize 

IpDataCompInfo 

data compression options to set 

Asynchronous. IpData is NULL, 



RIL SetPialedldStatus 

HRESULT RIL_SetDialedIdStatus(HRIL hRil, DWORD dwStatus) 

Sets the current DialedID settings 

hRil 

handle to RIL instance returned by RIL ^Initialize 

dwStatus 

status to be set {RIL_SVCSTAT_ constant) 
Asynchronous. IpData is NULL. 



RIL SetDTMFMonitoring 

HRESULT RIL_SetDTMFMonitoring(HRIL hRil, BOOL /Enable) 
Detects DTMF tones from an established voice call 

Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

/Enable 

TRUE to initiate DTMF monitoring; FALSE to cancel 



Parameters 



Comments 



Parameters 



Comments 
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Comments Asynchronous. IpData is NULL. 



RIL SetEquipmentState 

HRESULT RIL_SetEquipmentState(HRIL hRiU DWORD dwEquipmentState) 
Sets the equipment to the specified state 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

dwEquipmentState 

equipment state to set (RIL_EQSTATE_ constant) 

Comments Asynchronous. IpData is NULL. 



RIL SetErrorCorrection 

HRESULT RIL_SetErrorCorrection(HRIL hRil, const 
MLERRORCORRECTIOOTNFO*/;7£^rrorCorrec^zon/«/o) 
Set error correction options 
hRil 

handle to RIL instance returned by RIL_Initialize 

IpErrorCorrectionlnfo 

error correction options to set 

Asynchronous. IpData is NULL. 



RIL SetGPRSAttached 

HRESULT RIL_SetGPRSAttached(HRIL hRil, BOOL /Attached) 

Sets the GPRS attach state 

HRil 

handle to RIL instance returned by RIL_Initialize 

fAttached 

TRUE: attached, FALSE: detached 

Asynchronous. IpData is NULL. 



RIL SetGPRSClass 

HRESULT Rn._SetGPRSClass(HRIL hRiU DWORD dwClass) 
Sets the current GPRS class 
Parameters HRil 

handle to RIL instance returned by RIL_Initialize 



Parameters 



Comments 



Parameters 



Comments 
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dwClass 

a RIL_GPRSCLASS_* constant 

Comments Asynchronous. IpData is NULL 



RIL SetGPRSContext 

HRESULT RIL_SetGPRSContext(HRIL hRil, const RILGPRSCONTEXT 

IpGprs Context) 

Sets a particular GPRS context 

hRil 

handle to RIL instance returned by RIL_Initialize 

IpGprsContext 

points to a RILGPRSCONTEXT structure 

Asynchronous. IpData is NULL. 



RIL SetGPRSContextActivated 

HRESULT RIL_SetGPRSContextActivated(HRIL hRil, DWORD dwContextID, 

BOOL fContextActivation) 

Sets the GPRS activation state for a context 

hRil 

handle to RIL instance returned by RIL_Initialize 

dwContextID 

identifies the context 

fContextActivation 

TRUE: activated, FALSE: deactivated 

Asynchronous. IpData is NULL. 



RIL SetHideConnectedldStatus 

HRESULT Rn._SetHideConnectedIdStatus(HRn. hRil, DWORD dwStatus) 
Sets the current HideConnectedID settings 
Parameters hRil 

handle to RIL instance returned by RILJnitialize 

dwStatus 

status to be set (RIL^SVCSTAT^ constant) 
Comments Asynchronous. IpData is NULL. 



Parameters 



Comments 



Parameters 



Comments 



116 



laL SetHideldStatus 

HRESULT RIL_SetHideIdStatus(HRIL hRil, DWORD dwStatus) 
Enables or disables HidelD service 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

dwStatus 

status to be set (RIL_SVCSTAT_ constant) 
Comments Asynchronous. IpData is NULL, 



RIL SetHSCSDOptions 

HRESULT RIL_SetHSCSDOptions(HRIL hRil, const RILHSCSDINFO* IpHscsdInfo) 
Sets High Speeed Circuit Switched Data options 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

IpHscsdInfo 

High Speeed Circuit Switched Data options to set 
Comments Asynchronous. IpData is NULL. 



RIL SetLockingStatus 

HRESULT RD._SetLockingStatus(HRIL hRil, DWORD dwFacility, LPCSTR 

IpszPassword, DWORD dwStatus) 

Enables or disables locking status for the specified facility 

Parameters hRil 

handle to RIL instance returned by RILJnitialize 

dwFacility 

facility to enable/disable locking for (RILJLOCKFACILITY_ constant) 
IpszPassword 

password to enable/disable locking (can be NULL if password isrft required; no 
longer than MAXLENGTHJ'ASSWORD chars) 

dwStatus 

status to be set {RIL_LOCKINGSTATUS_ constant) 
Comments Asynchronous, IpData is NULL. 
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RIL SetMinimumOualityOfService 

HRESULT RIL_SetMinimumQualityOfService(HRIL hRil, const 
RILGPRSQOSPROFILE* IpGprsQosProfile) 
Sets the minimum quality of service profile for a context 
Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

IpGprsQosProfile 

points to a RILGPRSQOSPROFILE structure 

Comments Asynchronous. IpData is NULL, 



RIL SetMOSMSService 

HRESULT RIL_SetMOSMSService(HRIL hRiU DWORD dwMoSmsService) 

Sets the preferred SMS service option for mobile originated messages 

hRil 

handle to RIL instance returned by RIL_Initialize 

dwMoSmsService 

a RIL_MOSMSSERVICE_* constant 

Asynchronous. IpData is NULL 



RIL SetMsgConfig 

HRESULT RIL_SetMsgConrig(HRIL hRil, const RILMSGCONFIG* 

IpMsgConfiglnfd) 

Sets messaging configuration 

hRil 

handle to RIL instance returned by RILJnitialize 

IpMsgConfiglnfo 

messaging configuration to be set 

Asynchronous. IpData is NULL. 



RIL SetMsgServiceOptions 

HRESULT RIL_SetMsgServiceOptions(HRIL hRil, const RILMSGSERVICEINFO* 

IpMsgServicelnfo) 
Sets messaging service options 
Parameters hRil 

handle to RIL instance returned by RILJnitialize 



Parameters 



Comments 



Parameters 



Comments 
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IpMsgServicelnfo 

messaging service options to be set 

Comments Asynchronous. IpData is NULL, 



RIL SetPhonebookOptions 

HRESULT mL_SetPhonebookOptions(HRIL hRiU const RILPHONEBOOKINFO* 

IpPhonebooklnfd) 
Sets phonebook options 
hRil 

handle to RIL instance returned by RILJnitialize 

IpPhonebooklnfo 

phonebook options to set 

Asynchronous. IpData is NULL. 



RIL SetRequestedQualityOfService 

HRESULT RIL_SetRequestedQualityOfService(HRIL hRil, const 

RILGPRSQOSPROFILE* IpGprsQosProfile) 

Sets the requested quality of service profile for a context 

hRil 

handle to RIL instance returned by RIL_Initialize 

IpGprsQosProfile 

points to a RILGPRSQOSPROFILE structure 

Asynchronous. IpData is NULL, 



RIL SetRLPOptions 

HRESULT RIL_SetRLPOptions(HRIL hRil, const RILRLPINFO* IpRlpInfo) 
Sets Radio Link Protocol options 

Parameters hRil 

handle to RIL instance returned by RIL Jnitialize 

IpRlpInfo 

Radio Link Protocol options to set 

Comments Asynchronous. IpData is NULL. 



Parameters 



Comments 



Parameters 



Comments 



119 



RIL SetSimToolkitProfile 

HRESULT RIL_SetSimToolkitProme(HRIL hRih const BYTE* IpbProfile, DWORD 
dwSize) 

Sets SIM Toolkit terminal profile 

Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

IpbProfile 

SIM Toolkit profile to be set 

dwSize 

size of the data pointed to by IpbProfile in bytes 
Comments Asynchronous. IpData is NULL, 



RIL TerminateSimToolkitSession 

HRESULT RIL_TerminateSiniToolkitSession(HRIL hRil, DWORD dwCause) 

Terminates the SIM Toolkit session 

Parameters hRil 

handle to RIL instance returned by RIL_InitiaIize 

dwCause 

cause for session termination {RIL_SIMTKITTERMCAUSE_ constant) 
Comments Asynchronous. IpData is NULL. 



RIL TransferCall 

HRESULT Rn._TransferCall(HRIL hRil, const RILADDRESS* IpAddress, const 

RILSUBADDRESS* IpSubAddress) 

Transfers incoming allerting call to the specified number 

Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

IpAddress 

address to transfer the call to 

IpSubAddress 

sub-address to transfer the call to (can be NULL) 

Comments Asynchronous. IpData is NULL. 
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RIL UnlockPhone 



HRESULT RIL_UnlockPhone(HRIL hRil, LPCSTR IpszPassword, LPCSTR 
IpszNewPassword) 

Removes current lock applied to the phone 
Parameters hRil 

handle to RIL instance returned by RILJnitialize 

IpszPassword 

password to unlock the phone (no longer than MAXLENGTH__PASSWORD chars) 
IpszNewPassword 

new password (can be NULL, unless the current locked state is one of the 
RIL_LOCKEDSTATE_'^_PUK constants; no longer than 
MAXLENGTH_PASSWORD chars) 

Comments Asynchronous. IpData is NULL. 



RIL UnregisterFromNetwork 

HRESULT RIL_UnregisterFromNetwork(HRIL hRil) 
Uiu:egisters the ME from the current newtwork operator 

Parameters hRil 

handle to RIL instance returned by RIL_Initialize 

Comments Asynchronous. IpData is NULL, 



RIL WriteMsg 

HRESULT RIL_WriteMsg(HRIL hRil, const RILMESSAGE* IpMessage, DWORD 
dwStatus) 

Writes a message to the current storage location 
Parameters HRil 

handle to RIL instance returned by RILJnitialize 

IpMessage 

message to be written (of type RIL_MSGTYPEJN_pELIVER or 
RIL_MSGTYPE_OUTJUBMIT) 

dwStatus 

status to assigned to the written message (RIL_MSGSTATUS_ constant) 
Comments Asynchronous. IpData points to a DWORD conaining the index used. 
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RIL WritePhonebookEntry 



HRESULT RIL_WritePhonebookEntry(HRIL hRil, const 

RILPHONEBOOKENTRY* IpEntry) 

Writes a phonebook entry to the current storage location 

Parameters hRil 

handle to RIL instance returned by RJL_Initialize 

IpEntry 

phonebook entry to write out 

Comments Asynchronous. IpData is NULL. 



void (CALLBACK *RILNOTIFYCALLBACK) 

typedef void (CALLBACK *RILNOTIFYCALLBACK) (DWORD dwCode, const 
void* IpData, DWORD cbData, DWORD dwParam) 
RIL notification callback 
dwCode 

notification code 

IpData 

data associated with the notification 
cbData 

size of the strcuture pointed to IpData 

dwParam 

parameter passed to RJL_Initialize 

This function is called when the radio sends an unsolicited notifiation 



void (CALLBACK *RILRESULTCALLBACK) 

typedef void (CALLBACK *RILRESULTCALLBACK)(DWORD dwCode, 
HRESULT hrCmdID, const void* IpData, DWORD cbData, DWORD dwParam) 
RIL function result callback 
Parameters dwCode 

result code 

hrCmdID 

ID returned by the command that originated this response 
IpData 

data associated with the notification 
cbData 

size of the strcuture pointed to IpData 



Parameters 



Comments 
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dwParam 

parameter passed to RIL_Initialize 
Comments This function is called to send a return value after and asynchronous RIL function call 



RILADDRESS Structure 

typedef struct { 
DWORD cbSize; 
DWORD dwParams; 
DWORD dwType; 
DWORD dwNumPlan; 

WCHAR wszAddress[MAXLENGTH_ADDRESS] ; 
} RILADDRESS; 

Represents a phone number 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwType 

type of number 

dwNumPlan 

numbering plan 

wszAddress[MAXLENGTH_ADDRESS] 

address (min 3, max 43) 

Comments None 



RILAUDIODEVICEINFO Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwTxDevice; 

DWORD dwRxDevice; 
} RILAUDIODEVICEINFO; 

Audio device information 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwTxDevice 

transmit device 
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dwRxDevice 

receive device 

Comments None 



RILBEARERSVCINFO Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwSpeed; 

DWORD dwServiceName; 

DWORD dwConnectionElement; 
} RILBEARERSVCINFO; 

Bearer service settings 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwSpeed 

offered data speed (protocol dependant) 

dwServiceName 

type of data service 

dwConnectionElement 

indicates transparent or non-transparent connection 

Comments For RIL_BSVCCE_BOTH_ constants, the subsequent text indicates the preferred 

connection element. For instance, RIL_BSVCCE_BOTH_TRANSPARENT mQans that both 
transparent and non transparent are supported, but transparent is preferred. 



RILCALLERIDSETTINGS Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwStatus; 

DWORD dwProvisioning; 
} RILCALLERIDSETTINGS; 

Caller ID settings 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 
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dwStatus 

activation status 

dwProvisioning 

network provisioning status 

Comments None 



RILCALLFORWARDINGSETTING Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwStatus; 

DWORD dwInfoClasses; 

RILADDRESS raAddress; 

RILSUBADDRESS rsaSubAddress; 

DWORD dwDelayTime; 
} RILCALLFORWARDINGSETTING; 

Call forwarding service settings 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwStatus 

activation status 

dwInfoClasses 

indicates which classes of calls to forward 

raAddress 

forwarding address 

rsaSubAddress 

forwarding subaddress 

dwDelayTime 

seconds to wait in RIL_FWDREASON_NOREPLY c2.sq 

Comments None 



RILCALLHSCSDINFO Structure 

typedef struct { 
DWORD CbSize; 
DWORD dwParams; 
DWORD dwRxTime slots; 
DWORD dwTxTime slots; 
DWORD dwAirlnterfaceUserRate; 
DWORD dwChannelCoding; 
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} RILCALLHSCSDINFO; 

High speed circuit switched data information for the current call 
cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwRxTimeslots 

number of receive timeslots currently in use 

dwTxTimeslots 

number of transmit timeslots currently in use 

dwAirlnterfaceUserRate 

air interface user rate currently in use 

dwChannelCoding 

current channel coding 

None 



PgLCALLINFO Structure 

typedef struct { 
DWORD CbSize; 
DWORD dwParams; 
DWORD dwID; 
DWORD dwDirection; 
DWORD dwStatus; 
DWORD dwType; 
DWORD dwMultiparty; 
RILADDRESS raAddress; 

WCHAR wszDescription[MAXLENGTH_DESCRIPTION] ; 
} RILCALLINFO; 

Information about a specific call 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwID 

identifies each call 

dwDirection 

incoming or outgoing 

dwStatus 

properties of the call 

dwType 

voice or data or fax 



Members 



Comments 
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dwMultiparty 

conference call status 

raAddress 

call address 

wszDescription[MAXLENGTH_DESCRIPTION] 

any associated text 

Comments None 



RILCALLWAITINGINFO Structure 

typedef struct { 
DWORD cbSize; 
DWORD dwParams; 
DWORD dwCallType; 
DWORD dwAddressId; 

RILREMOTEPARTYINFO rrpiCaller Inf o; 
} RILCALLWAITINGINFO; 

Call waiting info 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwCallType 

type of call 

dwAddressId 

indicates address ID on which the incoming call arrived (if available) 

rrpiCallerlnfo 

caller information 

Comments None 



RILCAPSBARRINGPWDLENGTH Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwType; 

DWORD dwPasswordLength; 
} RILCAPSBARRINGPWDLENGTH; 

Call barring password length capabilities 
Members cbSize 

structure size in b3^es 
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dwParams 

indicates valid parameters 

dwType 

type of call barring 

dwPasswordLength 

maximum password length (TBD BUGBUG, should this be a range?) 

Comments None 



RILCAPSBEARERSVC Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwSpeedsl; 

DWORD dwSpeeds2; 

DWORD dwServiceNames; 

DWORD dwConnectionElements; 
} RILCAPSBEARERSVC; 

Bearer service capabilities 

Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwSpeedsl 

TBD 

dwSpeeds2 

TBD 

dwServiceNames 

TBD 

dwConnectionElements 

TBD 

Comments None 



RILCAPSDIAL Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwCallTypes; 

DWORD dwOptions; 
} RILCAPSDIAL; 

Dialing capabilities 
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Members 



cbSize 



structure size in bytes 

dwParams 

indicates valid paranaeters 

dwCallTypes 

type of call being placed 

dwOptions 

dialing options 



RILCAPSHSCSD Structure 



typedef struct { 

DWORD CbSize; 

DWORD dwParams; 

DWORD dwMultislotClass; 

DWORD dwMaxRxTime slots; 

DWORD dwMaxTxTime slots; 

DWORD dwMaxTotalTime slots; 

DWORD dwChannelCodings; 

DWORD dwAirlnterfaceUserRates; 

RILRANGE rrTopRxTimeslotRange ; 
} RILCAPSHSCSD; 

High Speed Circuit Switched Data capabilities 



structure size in bytes 

dwParams 

indicates valid parameters 

dwMultislotClass 

multislot class supported 

dwMaxRxTimeslots 

maximum number of receive timeslots 

dwMaxTxTimeslots 

maximum number of transmit timeslots 

dwMaxTotalTimeslots 

maximum number of total timeslots 

dwChannelCodings 

supported channel codings 

dwAirlnterfaceUserRates 

supported air interfacerates 

rrTopRxTimeslotRange 

TBD 



Comments 



None 



Members 



cbSize 



Comments 



None 
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RILCAPSLOCKINGPWDLENGTH Structure 



typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwFacility; 

DWORD dwPasswordLength; 
} RILCAPSLOCKINGPWDLENGTH; 

Locking password length capabilities 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwFacility 

the locking facility 

dwPasswordLength 

maximum password length (TBD BUGBUG, should this be a range?) 

Comments None 



RILCAPSMSGMEMORYLOCATIONS Structure 

typedef struct { 

DWORD CbSize; 

DWORD dwParams; 

DWORD dwReadLocations; 

DWORD dwWriteLocations ; 

DWORD dwStoreLocations; 
} RILCAPSMSGMEMORYLOCATIONS; 

Message memory location capabilities 
Members cbSize 

structure size in bj^es 

dwParams 

indicates valid parameters 

dwReadLocations 

supported read locations 

dwWriteLocations 

supported write locations 

dwStoreLocations 

supported store locations 

Comments None 
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RILCAPSRLP Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwVersion; 

RILRANGE rrlWSRange; 

RILRAKGE rrMWSRange; 

RILRANGE rrAckTime r Range ; 

RILRAKGE rrRetransmissionAttsRange; 

RILRANGE rrReseqPeriodRange; 
} RILCAPSRLP; 

Radio Link Protocol capabilities 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwVersion 

TBD 

rrlWSRange 

TBD 

rrMWSRange 

TBD 

rrAckTimerRange 

TBD 

rrRetransmissionAttsRange 

TBD 

rrReseqPeriodRange 
TBD 

Comments None 



RILCELLTQWERINFO Structure 

typedef struct { 
DWORD cbSize; 
DWORD dwParams; 
DWORD dwMobileCountryCode; 
DWORD dwMobileNetworkCode; 
DWORD dwLocationAreaCode; 
DWORD dwCelllD; 
DWORD dwBaseStationID; 
DWORD dwBroadcastControlChannel; 
DWORD dwRxLevel; 
DWORD dwRxLevelFull; 
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DWORD dwRxLevelSub; 
DWORD dwRxQuality; 
DWORD dwRxQualityFull; 
DWORD dwRxQualitySub; 
DWORD dwIdleTimeSlot; 
DWORD dwTimingAdvance; 
DWORD dwGPRSCelllD; 
DWORD dwGPRSBaseStationID; 
} RILCELLTOWERINFO; 

Cell tower info 
Members cbSize 

structxire size in bytes 

dwParams 

indicates valid parameters 

dwMobiieCountryCode 

TBD 

dwMobileNetworkCode 

TBD 

dwLocationAreaCode 

TBD 

dwCelUD 

TBD 

dwBaseStationID 

TBD 

dwBroadcastControlChannel 

TBD 

dwRxLevel 

Value from 0-63 (see GSM 05.08, 8.1.4) 

dwRxLevelFuU 

Value from 0-63 (see GSM 05.08, 8.1.4) 

dwRxLevelSub 

Value from 0-63 (see GSM 05.08, 8.1.4) 

dwRxQuality 

Value from 0-7 (see GSM 05.08, 8.2.4) 

dwRxQualityFull 

Value from 0-7 (see GSM 05.08, 8.2.4) 

dwRxQualitySub 

Value from 0-7 (see GSM 05.08, 8.2.4) 

dwIdleTimeSlot 

TBD 

dwTimingAdvance 

TBD 

dwGPRSCelllD 

TBD 
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dwGPRSBaseStationID 

TBD 

Comments None 



RILCLOSEDGROUPSETTINGS Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwStatus; 

DWORD dwindex; 

DWORD dwinfo; 
} RILCLOSEDGROUPSETTINGS; 

Close user group settings 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwStatus 

activation status 

dwindex 

CUG index 

dwinfo 

additional CUG flags 

Comments This feature is not used in Stinger and is untested. 



RILCONNECTINFO Structure 

typedef struct { 

DWORD CbSize; 

DWORD dwParams; 

DWORD dwCallType; 

DWORD dwBaudRate; 
} RILCONNECTINFO; 

Connection info 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwCallType 

type of the established connection {RIL_CALLTYPE_ constant) 
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dwBaudRate 

Baud rate of the established connection (set only for RIL_CALLTYPE_DATA) 



Comments None 



RILCOSTINFO Structure 

typedef struct { 
DWORD cbSize; 
DWORD dwParams; 
DWORD dwCCM; 
DWORD dwACM; 
DWORD dwMaxACM; 
DWORD dwCostPerUnit; 

WCHAR wszCurrency[MAXLENGTH_CURRENCY] ; 
} RILCOSTINFO; 

Service cost info 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwCCM 

current call meter 

dwACM 

accumulated call meter 

dwMaxACM 

maximum accumulated call meter 

dwCostPerUnit 

cost per unit, in 16.16 fixed point 

wszCurrency[MAXLENGTH_CURRENCY] 

current currency 

Comments None 



RILDATACOMPINFO Structure 

typedef struct { 

DWORD CbSize; 

DWORD dwParams; 

DWORD dwDi recti on; 

DWORD dwNegotiation; 

DWORD dwMaxDictEntries; 

DWORD dwMaxStringLength; 
} RILDATACOMPINFO; 
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Data compression settings 
cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwDirection 

compression in transmit and/or receive direcitons 

dwNegotiation 

compression is required or optional 

dwMaxDictEntries 

maximum number of dictionary entries 

dwMaxStringLength 

maximum string length 

None 



RILDIALEDIDSETTINGS Structure 

typedef struct { 
DWORD cbSize; 
DWORD dwParams; 
DWORD dwStatus; 
DWORD dwProvisioning; 
} RILDIALEDIDSETTINGS; 

Dialed ID settings 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwStatus 

activation status 

dwProvisioning 

network provisioning status 

Comments None 



RILDIALINFO Structure 

typedef struct { 

DWORD CbSize; 

DWORD dwParams; 

HRESULT hrCrudId; 

DWORD dwCallld; 
} RILDIALINFO; 



Members 



Comments 
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Ring information 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

hrCmdId 

handle of call being dialed 

dwCallld 

id of call being dialed 

Comments None 



RILENTERGPRSDATAMODE Structure 

typedef struct { 

DWORD cbSize; 
} RILENTERGPRSDATAMODE; 

A quality of service profile 
cbSize 

structure size in bytes 

None 

Disable "C4200: nonstandard extension used : zero-sized array in struct/union" 
dwLlProtocol 

an optional RILL2PR0T0C0L_* constant 

dwNum Contexts 

number of contexts which follow 

dwContextlDf] 

identifies the context(s) to enter data state 



RILEQUIPMENTINFO Structure 

typedef struct { 
DWORD CbSize; 
DWORD dwParams; 

char szManufacturer [MAXLENGTH_EQUIPINFO] ; 
char szModel [MAXLEISrGTH_EQUIPINFO] ; 
Char szRevision[MAXLENGTH_EQUIPINFO] ; 
char s2SerialNuraber[MAXLENGTH_EQUIPINF0] ; 
} RILEQUIPMENTINFO; 

Equipment info 
Members cbSize 

structure size in bytes 



Members 

Comments 
Parameters 
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dwParams 

indicates valid parameters 
szManufacturer[MAXLENGTH_EQUIPINFO] 

manufacturer of the radio hardware 
szModel[MAXLENGTH_EQUIPINFO] 

model of the radio hardware 
szRevision[MAXLENGTH_EQUIPINFO] 

software version of the radio stack 
szSeriaINumber[MAXLENGTH_EQUIPINFO] 

equipment identity (IMEI) 

Comments None 



RILEQUIPMENTSTATE Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwRadioSupport; 

DWORD dwEqState; 
} RILEQUIPMENTSTATE; 

Equipment state 
Members cbSize 

structure size in b3^es 

dwParams 

indicates valid parameters 

dwRadioSupport 

RIL_RADIOSUPPORT_* Parameter 

dwEqState 

RIL_EQSTATE_* Parameter 

Comments None 



RILERRQRCORRECTIONINFO Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwOriginalRequest; 

DWORD dwOriginalFallback; 

DWORD dwAnswerer Fallback; 
} RILERRORCORRECTIONINFO; 

Error correction settings 
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Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwOriginalRequest 

TBD 

dwOriginalFallback 
TBD 

dwAnswererFallback 

TBD 

Comments None 



RILGAININFO Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwTxGain; 

DWORD dwRxGain; 
} RILGAININFO; 

Audio gain information 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwTxGain 

transmit gain level (128 nominal, 0 automatic) 

dwRxGain 

receive gain level (128 nominal, 0 automatic) 

Comments None 



RILGPRSANSWER Structure 



Members 
Comments 



typedef struct { 

DWORD cbSize; 
} RILGPRSANSWER; 

A quality of service profile 
cbSize 

structure size in bytes 

None 

Disable "C4200: nonstandard extension used : zero-sized array in struct/union" 
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Parameters /Answer 

TRUE: accept, FALSE: reject 

dwL2Protocol 

an optional RILL2PR0T0C0L_* constant 

dwNum Contexts 

number of contexts which follow 

dwContextlDfJ 

identifies the context(s) to enter data state 



RILGPRSCONTEXT Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwContextID; 

DWORD dwProtocolType; 
RILGPRSCONTEXT; 

WCHAR wszAddress [MAXLENGTH_GPRSADDRESS] ; 

DWORD dwDataCompression; 

DWORD dwHeaderCompression; 

DWORD dwParameterLength; 

char szParameters [ ] ; 
} RILGPRSCONTEXT; 

A PDP Context represents a certain configuration for packet data communication. 

Members cbSize 

structure size in bytes 

dwParams 

indicates vahd parameters 

dwContextID 

the context number 

dwProtocolType 

a RIL_GPRSPROTOCOL__*constant 

RILGPRSCONTEXT 

a logical name to select the gateway gprs (which defines the external packet data 
network to use) 
wszAddress[MAXLENGTH_GPRS ADDRESS] 
the packet address to use (if null, request dynamic) 

dwDataCompression 

a RIL_GPRSDATACOMP_* 

dwHeaderCompression 

a RIL_GPRSHEADERCOMP_* 

dwParameterLength 

length of parameters list 
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szParameters[] 

parameters specific to the prococol type 

Comments None 

Disable "C4200: nonstandard extension used : zero-sized array in struct/union" 



RILGPRSCONTEXTACTIVATED Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwContextID; 

BOOL fActivated; 
} RILGPRSCONTEXTACTIVATED; 

Shows which contexts are active 
cbSize 

structure size in bytes 

dwContextID 

the context number 

fActivated 

whether the context is activated 

None 



RILGPRSPROTOCOLCAPS Structure 

typedef struct { 
DWORD CbSize; 
DWORD dwParams; 
DWORD dwProtocolType; 
DWORD dwPrecedenceClass; 
DWORD dwDelayClass; 
DWORD dwReliabilityClass; 
DWORD dwPeakThruClass; 
DWORD dwMeanThruClass; 
} RILGPRSPROTOCOLCAPS; 

General Packet Radio Service capabilities 
Members cbSize 

structure size in bytes (padded to DWORD) 

dwParams 

indicates valid parameters 

dwProtocolType 

a RIL_GPRSPROTOCOL_^* constant 

dwPrecedenceClass 

valid RIL_GPRSPRECEDENCECLASS_* constants 



Members 



Comments 
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dwDelayClass 

valid RIL_GPRSDELAYCLASS_* constants 

dwReliabilityCIass 

valid RIL_GPRSRELIABIL1TYCLASS_* constants 

dwPeakThruClass 

valid RIL_GPRSPEAKTHRUCLASS_* constants 

dwMeanThruClass 

valid RIL_GPRSMEANTHRUCLASS_* constants 

Comments tbdtbd 

Disable "C4200: nonstandard extension used : zero-sized array in struct/union 



RILGPRSPROTQCOLCAPS Structure 



typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwProtocolType; 

RILRANGE Context IDRange; 

DWORD dwDataCompression; 

DWORD dwHeaderCompression; 

DWORD dwParameterLength; 

char szParameters [ ] ; 
} RILGPRSPROTOCOLCAPS; 

General Packet Radio Service capabilities 

Members cbSize 

structure size in bytes (padded to DWORD) 

dwParams 

indicates valid parameters 

dwProtocolType 

a RIL_GPRSPROTOCOL_* constant 

ContextlDRange 

min/max context ids 

dwDataCompression 

valid data compression values 

dwHeaderCompression 

valid header compression values 

dwParameterLength 

length of parameters list in bytes 

szParameters[] 

vahd string parameters of this prococol type, delimited by , with final param 
terminated by 

Comments TBDTBD 

Disable "C4200: nonstandard extension used : zero-sized array m struct/union 
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RILGPRSQOSPROFILE Structure 



typedef struct { 

DWORD cbSize; 

DWORD dwPararns; 

DWORD dwContextID; 

DWORD dwPrecedenceClass; 

DWORD dwDelayClass; 

DWORD dwReliabilityClass; 

DWORD dwPeakThruClass; 

DWORD dwMeanThruClass; 
} RILGPRSQOSPROFILE; 

A quality of service profile 



structure size in bytes 

dwParams 

indicates valid parameters 

dwContextID 

the context number 

dwPrecedenceClass 

aRIL_GPRSPRECEDENCECLASS_* constant 

dwDelayClass 

a RIL_GPRSDELAYCLASS_* constant 

dwReliabilityClass 

a RIL__GPRSRELIABILITYCLASS_* constant 

dwPeakThruClass 

aRIL_GPRSPEAKTHRUCLASS_* constant 

dwMeanThruClass 

a RIL_GPRSMEANTHRUCLASS_* constant 



RILHIDECONNECTEDIDSETTINGS Structure 



typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwStatus; 

DWORD dwProvisioning; 
} RILHIDECONNECTEDIDSETTINGS; 

Hide Connected ID settings 



Members 



cbSize 



Comments 



None 



Members 



cbSize 

structure size in bytes 
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dwParams 

indicates valid parameters 

dwStatus 

activation status 

dwProvisioning 

network provisioning status 

Comments None 



RILHIDEIDSETTINGS Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwStatus; 

DWORD dwProvisioning; 
} RILHIDEIDSETTINGS; 

Hide ID settings 

Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwStatus 

activation status 

dwProvisioning 

network provisioning status 

Comments None 



RILHSCSDINFQ Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwTranspRxTime slots; 

DWORD dwTranspChannelCodings; 

DWORD dwNonTranspRxTime slots; 

DWORD dwNonTranspChannelCodings ; 

DWORD dwAirlnterfaceUserRate; 

DWORD dwRxTimeslotsLimit; 

BOOL f AutoSvcLevelUpgrading; 
} RILHSCSDINFQ; 

High speed circuit switched data settings 
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Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwTranspRxTimeslots 

number of receive timeslots for transparent HSCSD calls 

dwTranspChannelCodings 

accepted channel codings for transparent HSCSD calls 

dwNonTranspRxTimeslots 

number of receive timeslots for non-transparent HSCSD calls 

dwNonTranspChannelCodings 

accepted channel codings for non-transparent HSCSD calls 

dwAirlnterfaceUserRate 

air interface user rate for non-transparent HSCSD calls 

dwRxTimeslotsLimit 

maximum number of receive timeslots to be used during the next non-transparent 
HSCSD call 

fAutoSvcLevelUpgrading 

TRUE if automatic user-initiated service level upgrading for non-transparent 
HSCSD calls is enabled, FALSE otherwise 

Comments None 



RILMESSAGE Structure 

typedef struct { 
DWORD cbSize; 
DWORD dwParams; 
RILADDRESS raSvcCtrAddress ; 
DWORD dwType; 
DWORD dwFlags; 
union { 
struct { 

RILADDRESS raOrigAddress ; 
DWORD dwProtocolID; 
RILMSGDCS rmdDataCoding; 
SYSTEMTIME stSCReceiveTime; 
DWORD cbHdr Length; 
DWORD cchMsgLength; 
BYTE rgbHdr [MAXLEKGTH_HDR] ; 
BYTE rgbMsg [MAXLEKGTH_MSG] ; 

insglnDeliver; 
struct { 

DWORD dwTgtMsgReference; 
RILADDRESS raTgtRecipAddress ; 
SYSTEMTIME stTgtSCReceiveTime ; 
SYSTEMTIME stTgtDischargeTime; 
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DWORD dwTgtDlvStatus; 

DWORD dwProtocolID; 

RILMSGDCS rmdDataCoding; 

DWORD cbHdrLength; 

DWORD cchMsgLength; 

BYTE rgbHdr [MAXLENGTH_HDR] ; 

BYTE rgbMsg[MAXLENGTH_MSG] ; 

msglnStatus; 
struct { 

RILADDRESS raDestAddress ; 
DWORD dwProtocolID; 
RILMSGDCS rmdDataCoding; 
DWORD dwVPFormat; 
SYSTEMTIME stVP; 
DWORD CbHdrLength; 
DWORD cchMsgLength; 
BYTE rgbHdr [MAXLENGTH_HDR] ; 
BYTE rgbMsg[MAXLENGTH_MSG] ; 

ms gOut Submi t ; 
struct { 

DWORD dwProtocolID; 
DWORD dwCoimnandType; 
DWORD dwTgtMsgReference; 
RILADDRESS raDestAddress; 
DWORD cbCmdLength; 
BYTE rgbCmd[MAXLENGTH_CMD] ; 
ms gOu t C ornmand ; 
struct { 

DWORD dwGeoScope; 
DWORD dwMsgCode; 
DWORD dwUpdateNuitiber; 
DWORD dwID; 

RILMSGDCS rmdDataCoding; 
DWORD dwTotalPages; 
DWORD dwPageNumber; 
DWORD cchMsgLength; 
BYTE rgbMsg[MAXLENGTH__MSG] ; 

msgBcGeneral; 
DWORD cchMsgLength; 
BYTE rgbMsg[MAXLENGTH_MSG] ; 
msgOutRaw; 
} RILMESSAGE; 

Message data 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

raSvcCtr Address 

service center address 



dwType 

type of message 

dwFIags 

message flags 

UNION MEMBER 

RIL_MSGTYPE__IN_DELIVER 

raOrigAddress 

originating address 

dwProtocolID 

message protocol 

rmdDataCoding 

data coding scheme 

stSCReceiveTime 

receive time 

cbHdrLength 

length of header in bytes 

cchMsgLength 

length of body in bytes 

rgbHdr[MAXLENGTH_HDR] 

header buffer 

rgbMsg[MAXLENGTH_MSG] 

body buffer 

msglnDeliver 

End RIL_MSGTYPE_IN__DELIVER 

RIL_MSGTYPE_IN_STATUS 

dwTgtMsgReference 

target message reference 

raTgtRecipAddress 

receipient address 

stTgtSCReceiveTime 

receipient receive time 

stTgtDischargeTime 

receipient dischage time 

dwTgtDIvStatus 

delivery status 

dwProtocolID 

message protocol 

rmdDataCoding 

data coding scheme 
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cbHdrLength 

length of header in bytes 

cchMsgLength 

length of body in bytes 

rgbHdr[MAXLENGTH_HDR] 

header buffer 

rgbMsg[MAXLENGTH_MSG] 

body buffer 

msglnStatus 

End RIL_MSGTYPE_IN_STATUS 

RIL_MSGTYPE_OUT_SUBMIT 

raDestAddress 

destination address 

dwProtocoIID 

message protocol 

rmdDataCoding 

data coding scheme 

dwVPFormat 

TBD 

stVP 
TBD 

CbHdrLength 

length of header in bytes 

cchMsgLength 

length of body in bytes 

rgbHdr[MAXLENGTH_HDR] 

header buffer 

rgbMsg[MAXLENGTH_MSG] 

body buffer 

msgOutSubmit 

RIL_MSGTYPE_OUT__SUBMIT 

RIL_MSGTYPE__OUT_COMMAND 

dwProtocolID 

message protocol 

dwCommandType 

command type 

dwTgtMsgReference 

target message reference 

raDestAddress 

destination address 
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cbCmdLength 

length of command in bytes 

rgbCnid[MAXLENGTH CMD] 

command buffer 

msgOutCommand 

RIL_MSGTYPE_OUT_COMMAND 

RIL_MSGTYPE_BC_GENERAL 

dwGeoScope 

message protocol 

dwMsgCode 

message code 

dwUpdateNumber 

update number 

dwID 

identity 

rmdDataCoding 

data coding scheme 

dwTotaiPages 

total number of pages 

dwPageNumber 

current page number 

cchMsgLength 

length of message in bytes 

rgbMsg[MAXLENGTH_MSG] 

message buffer 

msgBcGeneral 

RIL__MSGTYPE_BC_GENERAL 

cchMsgLength 

length of body in bytes 

rgbMsg[MAXLENGTH_MSG] 

message buffer 

msgOutRaw 

RIL_MSGTYPE_OUT_RAW 
Comments None 



RILMESSAGE IN SIM Structure 

typedef struct { 
DWORD cbSize; 
DWORD dwLocation; 
DWORD dwindex; 
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} RILMESSAGE_IN_SIM; 

Message data in sim info 
Members cbSize 

structure size in bytes 

dwLocation 

storage area (one of RIL_MSGLOC_xxxx) 
dwindex 

storage index occupied by the message 
Comments None 



RILMESSAGEINFO Structure 

typedef struct { 
DWORD cbSize; 
DWORD dwParams; 
DWORD dwindex; 
DWORD dwStatus; 
RILMESSAGE ritMessage; 

} RILMESSAGE I NFC- 
Message data with additional info 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwindex 

storage index occupied by the message 

dwStatus 

message status 

rmMessage 

the message itself 

Comments None 



RILMSGCONFIG Structure 

typedef struct { 

DWORD CbSize; 

DWORD dwParams; 

RILADDRESS raSvcCtrAddress ; 

char szBroadcastMsglDs [MAXLENGTH_MSGIDS] 

DWORD dwBroadcastMsgLangs; 
} RILMSGCONFIG; 
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Messaging configuration 
cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

raSvcCtr Address 

service center address 

szBroadcastMsgIDs[MAXLENGTH_MSGroS] 

list of subscribed broadcast message IDs 

dwBroadcastMsgLangs 

broadcast message languages 

None 



RILMSGDCS Structure 



typedef struct { 


DWORD 


cbSize; 


DWORD 


dwParams ; 


DWORD 


dwType; 


DWORD 


dwFlags; 


DWORD 


dwMsgClass; 


DWORD 


dwAlphabet; 


DWORD 


dwindication; 


DWORD 


dwLanguage; 


} RILMSGDCS; 



Message data coding scheme 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwType 

DCS type 

dwFlags 

DCS flags 

dwMsgClass 

message class (Only for RIL_DCSTYPE_GENERAL and 
RIL_DCSTYPE_MSGCLASS) 

dwAlphabet 

DCS alphabet 

dwindication 

indication (Only for RIL_DCSTYPE_MSGWAIT) 

dwLanguage 

indication (Only for RIL_DCSTYPE_LANGUAGE) 



Members 



Comments 
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Comments None 



RILMSGSERVICEINFO Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwService; 

DWORD dwMsgClasses; 

DWORD dwReadLocation; 

DWORD dwReadUsed; 

DWORD dwReadTotal; 

DWORD dwWriteLocation; 

DWORD dwWriteUsed; 

DWORD dwWriteTotal; 

DWORD dwStoreLocation; 

DWORD dwStoreUsed; 

DWORD dwStoreTotal; 
} RILMSGSERVICEINFO; 

Messaging service settings 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwService 

supported service types 

dwMsgClasses 

supported message classes 

dwReadLocation 

currect read location 

dwReadUsed 

number of fields used 

dwReadTotal 

total number of fields 

dwWriteLocation 

currect read location 

dwWriteUsed 

number of fields used 

dwWriteTotal 

total number of fields 

dwStoreLocation 

currect read location 

dwStoreUsed 

number of fields used 
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dwStoreTotal 

total number of fields 

Comments None 



RILMSGSTORAGEINFO Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwReadLocation; 

DWORD dwWriteLocation; 

DWORD dwStoreLocation; 
} RILMSGSTORAGEINFO; 

Message storage locations 
cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwReadLocation 

current read location 

dwWriteLocation 

current write location 

dwStoreLocation 

current store location 
None 



RILOPERATORINFO Structure 

typedef struct { 
DWORD cbSize; 
DWORD dwParams; 
DWORD dwindex; 
DWORD dwStatus; 
RILOPERATORNAMES ronNames; 
} RILOPERATORINFO; 

Indicates status of a particular operator 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwindex 

index, if applicable 



Members 



Comments 
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dwStatus 

registration status, if applicable 

ronNames 

representations of an operator 
Comments None 



RILOPERATQRNAMES Structure 

typedef struct { 
DWORD cbSize; 
DWORD dwParams; 

char szLongName [MAXLENGTH_OPERATOR_LONG] ; 
char szShortName [MAXLENGTH_OPERATOR_SHORT] ; 
char szNumName [MAXLENGTH_OPERATOR_NUMERIC] ; 
} RILOPERATQRNAMES; 

The different representations of an operator 
cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

szLongName[MAXLENGTH_OPERATOR_LONG] 

long representation (max 16 characters) 

szShortName[MAXLENGTH_OPERATOR_SHORT] 

short representation (max 8 characters) 

szNumName[MAXLENGTH_OPERATOR_NUMERIC] 

numeric representation (3 digit country code & 2 digit network code) 
None 



RILPHONEBOOKENTRY Structure 

typedef struct { 
DWORD CbSize; 
DWORD dwParams; 
DWORD dwindex; 
RILADDRESS raAddress; 

WCHAR wszText [MAXLENGTH_PH0NEB00KTEXT] ; 
} RILPHONEBOOKENTRY; 

A single phonebook entry 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 



Members 



Comments 
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dwindex 

index of the entry 

raAddress 

the stored address 

wszText[MAXLENGTH_PHONEBOOKTEXT] 

assciated text 

Comments None 



RILPHONEBOOKINFO Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwStoreLocation; 

DWORD dwUsed; 

DWORD dwTotal; 
} RILPHONEBOOKINFO; 

Phonebook settings 
cbSize 

structure size in bytes 

dwParams 

indicates vahd parameters 

dwStoreLocation 

location of phonebook memory 

dwUsed 

number of locations used 

dwTotal 

total number of phonebook locations 
None 



RILRANGE Structure 

typedef struct { 

DWORD dwMinValue; 
DWORD dwMaxValue; 
} RILRANGE; 

Range of values 
Members dwMinValue 

minimum value 

dwMaxValue 

maximum value 



Members 



Comments 
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Comments None 



RILREMOTEPARTYINFO Structure 

typedef struct { 
DWORD cbSize; 
DWORD dwParains; 
RILADDRESS raAddress; 
RILSUBADDRESS rsaSubAddress ; 

WCHAR wszDescription[MAXLENGTH_DESCRIPTION] ; 
DWORD dwValidity; 
} RILREMOTEPARTYINFO; 

Incoming call info 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

raAddress 

address of caller 

rsaSubAddress 

subaddress of caller 

wszDescription[MAXLENGTH_DESCRIPTION] 

text associated with caller 

dwValidity 

indicates validity of caller info 
Comments None 



RILRINGINFO Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwCallType; 

DWORD dwAddressId; 

RILSERVICEINFO rsiServiceInf o; 
} RILRINGINFO; 

Ring information 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 
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dwCallType 

type of the offered call {RIL_CALLTYPE_ constant) 
dwAddressId 

indicates address ID on which the incoming call arrived (if available) 
rsiServicelnfo 

data connection service information (set only fox RIL_CALLTYPE_DATA) 
Comments None 



RILRLPINFO Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwIWS; 

DWORD dwMWS; 

DWORD dwAckTimer; 

DWORD dwRe t ransmis si onAt tempts; 

DWORD dwVersion; 

DWORD dwResequencingPeriod; 
} RILRLPINFO; 

Radio hnk protocol settings 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwIWS 

IWF-to-MS window size 

dwMWS 

MS-to-IWF window size 

dwAckTimer 

acknowledgement timer in 10s of milliseconds (Tl) 

dwRetransmissionAttempts 

number of retransmission attempts (N2) 

dwVersion 

RLP version number 

dwResequencingPeriod 

resequencing period (T4) 
Comments None 



RILSERIALPORTSTATS Structure 

typedef struct { 
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DWORD cbSize; 
DWORD dwParams; 
DWORD dwReadBitsPerSecond; 
DWORD dwWrittenBitsPerSecond; 
} RILSERIALPORTSTATS; 

Statistics of the virtual serial port 
Members cbSize 

structure size in bytes 
dwParams 

indicates valid parameters 

dwReadBitsPerSecond 

bit rate for reading data 

dwWrittenBitsPerSecond 

bit rate for vmting data 

Comments None 



RILSERVICEINFO Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

BOOL f Synchronous; 

BOOL f Transparent; 
} RILSERVICEINFO; 

Connection service information 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

fSynchronous 

TRUE if connection service is synchronous, FALSE if asynchronous 
fTransparent 

TRUE if connection service is transparent, FALSE if non-transparent 
Comments None 



RILSIGNALQUALITY Structure 

typedef struct { 
DWORD cbSize; 
DWORD dwParams; 
int nSignalStrength; 
int nMinSignalStrength; 
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int nMaxSignalStrength; 
DWORD dwBitErrorRate; 
int nLowSignalStrength; 
int nHighSignalStrength; 
} RILSIGNALQUALITY; 

Signal quality info 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

nSignalStrength 

TBD 

nMinSignalStrength 

TBD 

nMaxSignalStrength 
TBD 

dwBitErrorRate 

bit error rate in 1/100 of a percent 

nLowSignalStrength 
TBD 

nHighSignalStrength 

TBD 

Comments None 



RILSIMCMDPARAMETERS Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwFilelD; 

DWORD dwParameterl; 

DWORD dwParameter2; 

DWORD dwParameterS; 
} RILSIMCMDPARAMETERS; 

Parameters for a restricted SIM command 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwFilelD 

SIM file ID 

dwParameterl 

parameter specific to SIM command 
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dwParameter2 

parameter specific to SIM command 

dwParameter3 

parameter specific to SIM command 

Comments None 



RILSIMRECORDSTATUS Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwRecordType; 

DWORD dwItemCount; 

DWORD dwSize; 
} RILSIMRECORDSTATUS; 

Response to a restrcited SIM command 
cbSize 

Size of the structure in bytes 

dwParams 

Indicates valid parameter values 

dwRecordType 

RIL_SIMRECORDTYPE_* Constant 

dwItemCount 

Number of items in the record 

dwSize 

Size in bytes of each item 
None 



RILSIMRESPONSE Structure 

typedef struct { 
DWORD CbSize; 
DWORD dwParams; 
DWORD dwStatusWordl; 
DWORD dwStatusWord2; 
BYTE pbResponse [ ] ; 
} RILSIMRESPONSE; 

Response to a restrcited SIM command 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 



Members 



Comments 
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dwStatusWordl 

return parameter specific to SIM command 
dwStatusWord2 

return parameter specific to SIM command 
pbResponse[] 

additional bytes of response data 
Comments None 

Disable "C4200: nonstandard extension used : zero-sized array in struct/union" 



RILSIMTOOLKITNQTIFYCAPS Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 
} RILSIMTOOLKITNOTIFYCAPS; 

SIM TOOLKIT NOTIFY CAPABILITIES 
Members cbSize 

structure size in bytes 

dwPararas 

indicates valid parameters 

Comments This structure indicates who implements the various SIM ToolKit Notifications 

Values dwRefresh 

TBD 

dwMoreTime 

TBD 

dwPoIlInterval 

TBD 

dwPoUingOff 

TBD 

dwSetUpCall 

TBD 

dwSendSS 

TBD 

dwSendSMS 

TBD 

dwPlayTone 

TBD 

dwDisplayText 

TBD 

dwGetlnkey 

TBD 
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dwGetlnput 

TBD 

dwSelectltem 

TBD 

dwSetupMeau 

TBD 

dwLocallnfo 

TBD 



RILSUBADDRESS Structure 

typedef struct { 
DWORD cbSize; 
DWORD dwParams; 
DWORD dwType; 

WCHAR wszSubAddress [MAXLENGTH_SUBADDR] ; 
} RILSUBADDRESS; 

The subaddress of a called party 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwType 

type of subaddress 

wszSubAddress [MAXLENGTHSUBADDR] 

subaddress (min 2, max 23) 
Comments None 



RILSUBSCRIBERINFO Structure 

typedef struct { 
DWORD CbSize; 
DWORD dwParams; 
RILADDRESS raAddress; 

WCHAR wszDescription [MAXLENGTH_DESCRIPTION] 
DWORD dwSpeed; 
DWORD dwService; 
DWORD dwITC; 
DWORD dwAddressId; 
} RILSUBSCRIBERINFO; 

A phone number assigned to the user 
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Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

raAddress 

the assigned address 

wszDescription[MAXLENGTH_DESCRIPTIONI 

text relating to this subscriber 

dwSpeed 

data rate related to this number 

dwService 

the service related to this number 

dwITC 

information transfer capability 

dwAddressId 

the address ID of this number 

Comments None 



RILSUPSERVICEDATA Structure 

typedef struct { 

DWORD cbSize; 

DWORD dwParams; 

DWORD dwStatus; 

BYTE pbData [ ] ; 
} RILSUPSERVICEDATA; 

Supplementary service data 
Members cbSize 

structure size in bytes 

dwParams 

indicates valid parameters 

dwStatus 

additional status for message 

pbData[] 

message itself 

Comments None 

Disable "C4200: nonstandard extension used : zero-sized array in struct/union" 
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